主题
修改用户自定义设置 - SetConfigByKey
函数简介
通过键值对方式修改单个用户自定义设置项。等价于 SetConfig({"key": value})。
键名大小写不敏感；布尔/数值支持字符串（如 "True"、"1"）。与 OCR/YOLO 模型调参共用解析规则，见 JSON配置解析约定。
接口名称
SetConfigByKeyDLL调用
int SetConfigByKey(long ola, string key, string value);参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| ola | 长整数型 | OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。 |
| key | 字符串 | 配置项名称，如：RealMouseMode |
| value | 字符串 | 配置项值，如：true |
示例
SDK 调用
cpp
#include "OLAPlugServer.h"
OLAPlugServer ola;
ola.SetConfigByKey("DefaultEncoding", "1");csharp
using OLAPlug;
var ola = new OLAPlugServer();
ola.SetConfigByKey("DefaultEncoding", "1");python
from OLAPlugServer import OLAPlugServer
ola = OLAPlugServer()
ola.SetConfigByKey("DefaultEncoding", "1")java
import com.olaplug.OLAPlugServer;
OLAPlugServer ola = new OLAPlugServer();
ola.SetConfigByKey("DefaultEncoding", "1");cpp
var ola = com("OlaPlug.OlaSoft")
ola.SetConfigByKey("DefaultEncoding", "1");vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
ola.SetConfigByKey("DefaultEncoding", "1");text
.局部变量 ola, OLAPlug
ola.创建 ()
ola.SetConfigByKey("DefaultEncoding", "1")aardio
import OLAPlugServer;
var ola = OLAPlugServer();
ola.SetConfigByKey("DefaultEncoding", "1");text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
ola.SetConfigByKey("DefaultEncoding", "1");cpp
#include "OLAPlugServer.h"
OLAPlugServer ola;
ola.SetConfigByKey("DefaultEncoding", "1");原生 DLL 调用
cpp
long instance = CreateCOLAPlugInterFace();
SetConfigByKey(instance, "DefaultEncoding", "1");csharp
long instance = CreateCOLAPlugInterFace();
SetConfigByKey(instance, "DefaultEncoding", "1");python
from ctypes import CDLL, c_int, c_int64, create_string_buffer
ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
SetConfigByKey(instance, "DefaultEncoding", "1")返回值
整数型：1 成功，0 失败。
可用配置项
编码与键鼠仿真（全局）
| 配置项 | 类型 | 说明 |
|---|---|---|
| DefaultEncoding | 整数型 | 接口调用参数默认编码。0.GBK(默认) 1.UTF-8 2.Unicode (*全局唯一,所有欧拉对象共享) |
| DefaultReturnEncoding | 整数型 | 接口返回值默认编码。0.GBK 1.UTF-8(默认) 2.Unicode (*全局唯一,所有欧拉对象共享) |
| SimModeType | 整数型 | 键鼠仿真模式。0.标准模式 1.Logitech驱动 2.LogitechGHubNew 3.Razer 4.欧拉驱动 (*全局唯一,所有欧拉对象共享) |
| OLAMouseDeviceMode | 整数型 | 欧拉驱动鼠标模式 0~10，默认0，部分模式可能蓝屏，建议从0开始尝试 (*全局唯一,所有欧拉对象共享) |
| OLAKeypadDeviceMode | 整数型 | 欧拉驱动键盘模式 0~10，默认0，部分模式可能蓝屏，建议从0开始尝试 (*全局唯一,所有欧拉对象共享) |
| UseAbsoluteMove | bool型 | 驱动鼠标是否使用绝对移动，默认true (*全局唯一,所有欧拉对象共享) |
真实鼠标轨迹
| 配置项 | 类型 | 说明 |
|---|---|---|
| EnableRealMouse | bool型 | 是否启用真实鼠标轨迹，默认true |
| RealMouseMode | 整数型 | 鼠标模式，默认6。1.标准计算机用户 2.游戏玩家 3.非光学鼠标(慢) 4.平衡版本 5.机器人模式(直线) 6.自定义模式 |
| MinMouseTrajectory | 整数型 | 最小鼠标轨迹距离（像素），小于该长度不使用轨迹，默认50 |
| RealMouseBaseTimePer100Pixels | 整数型 | 每100像素的基础移动时间（毫秒），默认100 |
| RealMouseFlowFlag | 整数型 | 移动时间控制，组合不同速度曲线，默认161。1:变化速度曲线 2:中断移动 4:另一种中断模式 8:慢启动 16:另一种慢启动 32:锯齿状移动 64:停止移动 128:调整移动 256:随机移动 512:恒定速度 |
| RealMouseNoise | 双精度浮点数 | 噪声控制，影响轨迹随机性，默认5.0 |
| RealMouseDeviation | 整数型 | 偏差控制，影响路径曲率，默认5 |
| RealMouseMinSteps | 整数型 | 最小步数，控制移动中的点数，默认300 |
| RealMouseTimeToSteps | 双精度浮点数 | 控制步之间的时间间隔，默认2.5 |
| RealMouseOvershoots | 整数型 | 过冲点数，默认0 |
| MouseDriftCheckTime | 整数型 | 鼠标漂移检测时间（毫秒），0不检测，默认0 |
| MousePosCallbackMinOffset | 整数型 | 鼠标位置回调偏差阈值（像素）。|offsetX| 与 |offsetY| 均小于该值时不触发 MoveTo 终点矫正；0=不限制，默认0。须配合 SetMousePosCallback 使用 |
键盘鼠标间隔与输入锁定
| 配置项 | 类型 | 说明 |
|---|---|---|
| EnableRealKeypad | bool型 | 是否启用真实键盘输入延时，默认false |
| KeyDownInterval | 整数型 | 键盘单击间隔（毫秒），默认50 |
| MouseClickInterval | 整数型 | 鼠标单击间隔（毫秒），默认50 |
| MouseDoubleClickInterval | 整数型 | 鼠标双击间隔（毫秒），默认200 |
| InputLock | bool型 | 输入锁定状态，默认false |
| KeyboardHwnd | 长整数型 | 键盘窗口句柄，默认0 |
| MouseHwnd | 长整数型 | 鼠标窗口句柄，默认0 |
| CheckDisplayDeadInterval | 整数型 | 检测卡死屏幕时间间隔（毫秒），0不检测，默认50 |
VNC 连接
| 配置项 | 类型 | 说明 |
|---|---|---|
| VncServer | 字符串 | VNC服务器地址，默认"127.0.0.1" |
| VncPort | 整数型 | VNC服务器端口，默认5900 |
| VncPassword | 字符串 | VNC密码 |
路径、数据库与图像（全局）
| 配置项 | 类型 | 说明 |
|---|---|---|
| WorkPath | 字符串 | 工作路径 (*全局唯一,所有欧拉对象共享) |
| DbPath | 字符串 | SQLite数据库路径 (*全局唯一,所有欧拉对象共享) |
| DbPassword | 字符串 | SQLite数据库密码 (*全局唯一,所有欧拉对象共享) |
| DriverPath | 字符串 | 自定义驱动路径 (*全局唯一,所有欧拉对象共享) |
| SymbolServer | 字符串 | 符号服务器地址，如 https://msdl.microsoft.com (*全局唯一,所有欧拉对象共享) |
| SharedMemoryNamePrefix | 字符串 | 共享内存命名前缀，用于配置沙盒，默认"TSVN_" (*全局唯一,所有欧拉对象共享) |
| JpegQuality | 整数型 | JPG压缩质量 0~100，默认100 (*全局唯一,所有欧拉对象共享) |
| MaxOverlap | 双精度浮点数 | 多图返回的最大重叠度，0为完全不重叠，默认0.5 (*全局唯一,所有欧拉对象共享) |
| MatchColorWeight | 双精度浮点数 | 彩色模式颜色权重 0~1.0，默认0.7 (*全局唯一,所有欧拉对象共享) |
| ImageStitchMatchValue | 双精度浮点数 | 图片拼接匹配值 0~1，默认0 (*全局唯一,所有欧拉对象共享) |
| MultiTemplateAbortOnInvalidImage | bool型 | 多模板路径中某一图加载失败时：true=整次失败；false=跳过无效模板，默认true (*全局唯一,所有欧拉对象共享) |
| MultiColorSimMode | 整数型 | 多点找色 sim 模式，默认0。0.对颜色做相似度 1.对识别点阵数量做相似度 (*全局唯一,所有欧拉对象共享) |
| EnableOcrOverlapCounting | bool型 | OCR结果合并是否允许重叠统计（长词与内部短词可同时返回），默认false (*全局唯一,所有欧拉对象共享) |
窗口、虚拟机与远程（全局）
| 配置项 | 类型 | 说明 |
|---|---|---|
| FindWindowMode | 整数型 | 查找窗口模式。0.只查询可见窗口 1.查询所有窗口 2.查询不可见窗口，默认0 (*全局唯一) |
| VMwareVersion | 整数型 | VMware版本，-1自动判断注册表，支持 10/16/17/18/19，默认-1 (*全局唯一) |
| RemoteServerExeName | 字符串 | SHM自动发现B端时按此进程名枚举，默认"RemoteServer.exe" (*全局唯一) |